v18.3.1

Compare Source

v18.3.0

Compare Source

v18.2.0

Compare Source

React DOM

• Provide a component stack as a second argument to onRecoverableError. (@​gnoff in #​24591)
• Fix hydrating into document causing a blank page on mismatch. (@​gnoff in #​24523)
• Fix false positive hydration errors with Suspense. (@​gnoff in #​24480 and @​acdlite in #​24532)
• Fix ignored setState in Safari when adding an iframe. (@​gaearon in #​24459)

React DOM Server

• Pass information about server errors to the client. (@​salazarm and @​gnoff in #​24551 and #​24591)
• Allow to provide a reason when aborting the HTML stream. (@​gnoff in #​24680)
• Eliminate extraneous text separators in the HTML where possible. (@​gnoff in #​24630)
• Disallow complex children inside <title> elements to match the browser constraints. (@​gnoff in #​24679)
• Fix buffering in some worker environments by explicitly setting highWaterMark to 0. (@​jplhomer in #​24641)

Server Components (Experimental)

• Add support for useId() inside Server Components. (@​gnoff in #​24172)

v18.1.0

Compare Source

React DOM

• Fix the false positive warning about react-dom/client when using UMD bundle. (@​alireza-molaee in #​24274)
• Fix suppressHydrationWarning to work in production too. (@​gaearon in #​24271)
• Fix componentWillUnmount firing twice inside of Suspense. (@​acdlite in #​24308)
• Fix some transition updates being ignored. (@​acdlite in #​24353)
• Fix useDeferredValue causing an infinite loop when passed an unmemoized value. (@​acdlite in #​24247)
• Fix throttling of revealing Suspense fallbacks. (@​sunderls in #​24253)
• Fix an inconsistency in whether the props object is the same between renders. (@​Andarist and @​acdlite in #​24421)
• Fix a missing warning about a setState loop in useEffect. (@​gaearon in #​24298)
• Fix a spurious hydration error. (@​gnoff in #​24404)
• Warn when calling setState in useInsertionEffect. (@​gaearon in #​24295)
• Ensure the reason for hydration errors is always displayed. (@​gaearon in #​24276)

React DOM Server

• Fix escaping for the bootstrapScriptContent contents. (@​gnoff in #​24385)
• Significantly improve performance of renderToPipeableStream. (@​gnoff in #​24291)

ESLint Plugin: React Hooks

• Fix false positive errors with a large number of branches. (@​scyron6 in #​24287)
• Don't consider a known dependency stable when the variable is reassigned. (@​afzalsayed96 in #​24343)

Use Subscription

• Replace the implementation with the use-sync-external-store shim. (@​gaearon in #​24289)

v18.0.0

Compare Source

Below is a list of all new features, APIs, deprecations, and breaking changes.
Read React 18 release post and React 18 upgrade guide for more information.

New Features

React

• useId is a new hook for generating unique IDs on both the client and server, while avoiding hydration mismatches. It is primarily useful for component libraries integrating with accessibility APIs that require unique IDs. This solves an issue that already exists in React 17 and below, but it’s even more important in React 18 because of how the new streaming server renderer delivers HTML out-of-order.
• startTransition and useTransition let you mark some state updates as not urgent. Other state updates are considered urgent by default. React will allow urgent state updates (for example, updating a text input) to interrupt non-urgent state updates (for example, rendering a list of search results).
• useDeferredValue lets you defer re-rendering a non-urgent part of the tree. It is similar to debouncing, but has a few advantages compared to it. There is no fixed time delay, so React will attempt the deferred render right after the first render is reflected on the screen. The deferred render is interruptible and doesn't block user input.
• useSyncExternalStore is a new hook that allows external stores to support concurrent reads by forcing updates to the store to be synchronous. It removes the need for useEffect when implementing subscriptions to external data sources, and is recommended for any library that integrates with state external to React.
• useInsertionEffect is a new hook that allows CSS-in-JS libraries to address performance issues of injecting styles in render. Unless you’ve already built a CSS-in-JS library we don’t expect you to ever use this. This hook will run after the DOM is mutated, but before layout effects read the new layout. This solves an issue that already exists in React 17 and below, but is even more important in React 18 because React yields to the browser during concurrent rendering, giving it a chance to recalculate layout.

React DOM Client

These new APIs are now exported from react-dom/client:

• createRoot: New method to create a root to render or unmount. Use it instead of ReactDOM.render. New features in React 18 don't work without it.
• hydrateRoot: New method to hydrate a server rendered application. Use it instead of ReactDOM.hydrate in conjunction with the new React DOM Server APIs. New features in React 18 don't work without it.

Both createRoot and hydrateRoot accept a new option called onRecoverableError in case you want to be notified when React recovers from errors during rendering or hydration for logging. By default, React will use reportError, or console.error in the older browsers.

React DOM Server

These new APIs are now exported from react-dom/server and have full support for streaming Suspense on the server:

• renderToPipeableStream: for streaming in Node environments.
• renderToReadableStream: for modern edge runtime environments, such as Deno and Cloudflare workers.

The existing renderToString method keeps working but is discouraged.

v17.0.2

Compare Source

React DOM

• Remove an unused dependency to address the SharedArrayBuffer cross-origin isolation warning. (@​koba04 and @​bvaughn in #​20831, #​20832, and #​20840)

v17.0.1

Compare Source

React DOM

• Fix a crash in IE11. (@​gaearon in #​20071)

v17.0.0

Compare Source

Today, we are releasing React 17!

Learn more about React 17 and how to update to it on the official React blog.

React

• Add react/jsx-runtime and react/jsx-dev-runtime for the new JSX transform. (@​lunaruan in #​18299)
• Build component stacks from native error frames. (@​sebmarkbage in #​18561)
• Allow to specify displayName on context for improved stacks. (@​eps1lon in #​18224)
• Prevent 'use strict' from leaking in the UMD bundles. (@​koba04 in #​19614)
• Stop using fb.me for redirects. (@​cylim in #​19598)

React DOM

• Delegate events to roots instead of document. (@​trueadm in #​18195 and others)
• Clean up all effects before running any next effects. (@​bvaughn in #​17947)
• Run useEffect cleanup functions asynchronously. (@​bvaughn in #​17925)
• Use browser focusin and focusout for onFocus and onBlur. (@​trueadm in #​19186)
• Make all Capture events use the browser capture phase. (@​trueadm in #​19221)
• Don't emulate bubbling of the onScroll event. (@​gaearon in #​19464)
• Throw if forwardRef or memo component returns undefined. (@​gaearon in #​19550)
• Remove event pooling. (@​trueadm in #​18969)
• Stop exposing internals that won’t be needed by React Native Web. (@​necolas in #​18483)
• Attach all known event listeners when the root mounts. (@​gaearon in #​19659)
• Disable console in the second render pass of DEV mode double render. (@​sebmarkbage in #​18547)
• Deprecate the undocumented and misleading ReactTestUtils.SimulateNative API. (@​gaearon in #​13407)
• Rename private field names used in the internals. (@​gaearon in #​18377)
• Don't call User Timing API in development. (@​gaearon in #​18417)
• Disable console during the repeated render in Strict Mode. (@​sebmarkbage in #​18547)
• In Strict Mode, double-render components without Hooks too. (@​eps1lon in #​18430)
• Allow calling ReactDOM.flushSync during lifecycle methods (but warn). (@​sebmarkbage in #​18759)
• Add the code property to the keyboard event objects. (@​bl00mber in #​18287)
• Add the disableRemotePlayback property for video elements. (@​tombrowndev in #​18619)
• Add the enterKeyHint property for input elements. (@​eps1lon in #​18634)
• Warn when no value is provided to <Context.Provider>. (@​charlie1404 in #​19054)
• Warn when memo or forwardRef components return undefined. (@​bvaughn in #​19550)
• Improve the error message for invalid updates. (@​JoviDeCroock in #​18316)
• Exclude forwardRef and memo from stack frames. (@​sebmarkbage in #​18559)
• Improve the error message when switching between controlled and uncontrolled inputs. (@​vcarl in #​17070)
• Keep onTouchStart, onTouchMove, and onWheel passive. (@​gaearon in #​19654)
• Fix setState hanging in development inside a closed iframe. (@​gaearon in #​19220)
• Fix rendering bailout for lazy components with defaultProps. (@​jddxf in #​18539)
• Fix a false positive warning when dangerouslySetInnerHTML is undefined. (@​eps1lon in #​18676)
• Fix Test Utils with non-standard require implementation. (@​just-boris in #​18632)
• Fix onBeforeInput reporting an incorrect event.type. (@​eps1lon in #​19561)
• Fix event.relatedTarget reported as undefined in Firefox. (@​claytercek in #​19607)
• Fix "unspecified error" in IE11. (@​hemakshis in #​19664)
• Fix rendering into a shadow root. (@​Jack-Works in #​15894)
• Fix movementX/Y polyfill with capture events. (@​gaearon in #​19672)
• Use delegation for onSubmit and onReset events. (@​gaearon in #​19333)
• Improve memory usage. (@​trueadm in #​18970)

React DOM Server

• Make useCallback behavior consistent with useMemo for the server renderer. (@​alexmckenley in #​18783)
• Fix state leaking when a function component throws. (@​pmaccart in #​19212)

React Test Renderer

• Improve findByType error message. (@​henryqdineen in #​17439)

Concurrent Mode (Experimental)

• Revamp the priority batching heuristics. (@​acdlite in #​18796)
• Add the unstable_ prefix before the experimental APIs. (@​acdlite in #​18825)
• Remove unstable_discreteUpdates and unstable_flushDiscreteUpdates. (@​trueadm in #​18825)
• Remove the timeoutMs argument. (@​acdlite in #​19703)
• Disable <div hidden /> prerendering in favor of a different future API. (@​acdlite in #​18917)
• Add unstable_expectedLoadTime to Suspense for CPU-bound trees. (@​acdlite in #​19936)
• Add an experimental unstable_useOpaqueIdentifier Hook. (@​lunaruan in #​17322)
• Add an experimental unstable_startTransition API. (@​rickhanlonii in #​19696)
• Using act in the test renderer no longer flushes Suspense fallbacks. (@​acdlite in #​18596)
• Use global render timeout for CPU Suspense. (@​sebmarkbage in #​19643)
• Clear the existing root content before mounting. (@​bvaughn in #​18730)
• Fix a bug with error boundaries. (@​acdlite in #​18265)
• Fix a bug causing dropped updates in a suspended tree. (@​acdlite in #​18384 and #​18457)
• Fix a bug causing dropped render phase updates. (@​acdlite in #​18537)
• Fix a bug in SuspenseList. (@​sebmarkbage in #​18412)
• Fix a bug causing Suspense fallback to show too early. (@​acdlite in #​18411)
• Fix a bug with class components inside SuspenseList. (@​sebmarkbage in #​18448)
• Fix a bug with inputs that may cause updates to be dropped. (@​jddxf in #​18515 and @​acdlite in #​18535)
• Fix a bug causing Suspense fallback to get stuck. (@​acdlite in #​18663)
• Don't cut off the tail of a SuspenseList if hydrating. (@​sebmarkbage in #​18854)
• Fix a bug in useMutableSource that may happen when getSnapshot changes. (@​bvaughn in #​18297)
• Fix a tearing bug in useMutableSource. (@​bvaughn in #​18912)
• Warn if calling setState outside of render but before commit. (@​sebmarkbage in #​18838)

v18.3.1

Compare Source

v18.3.0

Compare Source

v18.2.0

Compare Source

React DOM

• Provide a component stack as a second argument to onRecoverableError. (@​gnoff in #​24591)
• Fix hydrating into document causing a blank page on mismatch. (@​gnoff in #​24523)
• Fix false positive hydration errors with Suspense. (@​gnoff in #​24480 and @​acdlite in #​24532)
• Fix ignored setState in Safari when adding an iframe. (@​gaearon in #​24459)

React DOM Server

• Pass information about server errors to the client. (@​salazarm and @​gnoff in #​24551 and #​24591)
• Allow to provide a reason when aborting the HTML stream. (@​gnoff in #​24680)
• Eliminate extraneous text separators in the HTML where possible. (@​gnoff in #​24630)
• Disallow complex children inside <title> elements to match the browser constraints. (@​gnoff in #​24679)
• Fix buffering in some worker environments by explicitly setting highWaterMark to 0. (@​jplhomer in #​24641)

Server Components (Experimental)

• Add support for useId() inside Server Components. (@​gnoff in #​24172)

v18.1.0

Compare Source

React DOM

• Fix the false positive warning about react-dom/client when using UMD bundle. (@​alireza-molaee in #​24274)
• Fix suppressHydrationWarning to work in production too. (@​gaearon in #​24271)
• Fix componentWillUnmount firing twice inside of Suspense. (@​acdlite in #​24308)
• Fix some transition updates being ignored. (@​acdlite in #​24353)
• Fix useDeferredValue causing an infinite loop when passed an unmemoized value. (@​acdlite in #​24247)
• Fix throttling of revealing Suspense fallbacks. (@​sunderls in #​24253)
• Fix an inconsistency in whether the props object is the same between renders. (@​Andarist and @​acdlite in #​24421)
• Fix a missing warning about a setState loop in useEffect. (@​gaearon in #​24298)
• Fix a spurious hydration error. (@​gnoff in #​24404)
• Warn when calling setState in useInsertionEffect. (@​gaearon in #​24295)
• Ensure the reason for hydration errors is always displayed. (@​gaearon in #​24276)

React DOM Server

• Fix escaping for the bootstrapScriptContent contents. (@​gnoff in #​24385)
• Significantly improve performance of renderToPipeableStream. (@​gnoff in #​24291)

ESLint Plugin: React Hooks

• Fix false positive errors with a large number of branches. (@​scyron6 in #​24287)
• Don't consider a known dependency stable when the variable is reassigned. (@​afzalsayed96 in #​24343)

Use Subscription

• Replace the implementation with the use-sync-external-store shim. (@​gaearon in #​24289)

v18.0.0

Compare Source

Below is a list of all new features, APIs, deprecations, and breaking changes.
Read React 18 release post and React 18 upgrade guide for more information.

New Features

React

• useId is a new hook for generating unique IDs on both the client and server, while avoiding hydration mismatches. It is primarily useful for component libraries integrating with accessibility APIs that require unique IDs. This solves an issue that already exists in React 17 and below, but it’s even more important in React 18 because of how the new streaming server renderer delivers HTML out-of-order.
• startTransition and useTransition let you mark some state updates as not urgent. Other state updates are considered urgent by default. React will allow urgent state updates (for example, updating a text input) to interrupt non-urgent state updates (for example, rendering a list of search results).
• useDeferredValue lets you defer re-rendering a non-urgent part of the tree. It is similar to debouncing, but has a few advantages compared to it. There is no fixed time delay, so React will attempt the deferred render right after the first render is reflected on the screen. The deferred render is interruptible and doesn't block user input.
• useSyncExternalStore is a new hook that allows external stores to support concurrent reads by forcing updates to the store to be synchronous. It removes the need for useEffect when implementing subscriptions to external data sources, and is recommended for any library that integrates with state external to React.
• useInsertionEffect is a new hook that allows CSS-in-JS libraries to address performance issues of injecting styles in render. Unless you’ve already built a CSS-in-JS library we don’t expect you to ever use this. This hook will run after the DOM is mutated, but before layout effects read the new layout. This solves an issue that already exists in React 17 and below, but is even more important in React 18 because React yields to the browser during concurrent rendering, giving it a chance to recalculate layout.

React DOM Client

These new APIs are now exported from react-dom/client:

• createRoot: New method to create a root to render or unmount. Use it instead of ReactDOM.render. New features in React 18 don't work without it.
• hydrateRoot: New method to hydrate a server rendered application. Use it instead of ReactDOM.hydrate in conjunction with the new React DOM Server APIs. New features in React 18 don't work without it.

Both createRoot and hydrateRoot accept a new option called onRecoverableError in case you want to be notified when React recovers from errors during rendering or hydration for logging. By default, React will use reportError, or console.error in the older browsers.

React DOM Server

These new APIs are now exported from react-dom/server and have full support for streaming Suspense on the server:

• renderToPipeableStream: for streaming in Node environments.
• renderToReadableStream: for modern edge runtime environments, such as Deno and Cloudflare workers.

The existing renderToString method keeps working but is discouraged.

v17.0.2

Compare Source

React DOM

• Remove an unused dependency to address the SharedArrayBuffer cross-origin isolation warning. (@​koba04 and @​bvaughn in #​20831, #​20832, and #​20840)

v17.0.1

Compare Source

React DOM

• Fix a crash in IE11. (@​gaearon in #​20071)

v17.0.0

Compare Source

Today, we are releasing React 17!

Learn more about React 17 and how to update to it on the official React blog.

React

• Add react/jsx-runtime and react/jsx-dev-runtime for the new JSX transform. (@​lunaruan in #​18299)
• Build component stacks from native error frames. (@​sebmarkbage in #​18561)
• Allow to specify displayName on context for improved stacks. (@​eps1lon in #​18224)
• Prevent 'use strict' from leaking in the UMD bundles. (@​koba04 in #​19614)
• Stop using fb.me for redirects. (@​cylim in #​19598)

React DOM

• Delegate events to roots instead of document. (@​trueadm in #​18195 and others)
• Clean up all effects before running any next effects. (@​bvaughn in #​17947)
• Run useEffect cleanup functions asynchronously. (@​bvaughn in #​17925)
• Use browser focusin and focusout for onFocus and onBlur. (@​trueadm in #​19186)
• Make all Capture events use the browser capture phase. (@​trueadm in #​19221)
• Don't emulate bubbling of the onScroll event. (@​gaearon in #​19464)
• Throw if forwardRef or memo component returns undefined. (@​gaearon in #​19550)
• Remove event pooling. (@​trueadm in #​18969)
• Stop exposing internals that won’t be needed by React Native Web. (@​necolas in #​18483)
• Attach all known event listeners when the root mounts. (@​gaearon in #​19659)
• Disable console in the second render pass of DEV mode double render. (@​sebmarkbage in #​18547)
• Deprecate the undocumented and misleading ReactTestUtils.SimulateNative API. (@​gaearon in #​13407)
• Rename private field names used in the internals. (@​gaearon in #​18377)
• Don't call User Timing API in development. (@​gaearon in #​18417)
• Disable console during the repeated render in Strict Mode. (@​sebmarkbage in #​18547)
• In Strict Mode, double-render components without Hooks too. (@​eps1lon in #​18430)
• Allow calling ReactDOM.flushSync during lifecycle methods (but warn). (@​sebmarkbage in #​18759)
• Add the code property to the keyboard event objects. (@​bl00mber in #​18287)
• Add the disableRemotePlayback property for video elements. (@​tombrowndev in #​18619)
• Add the enterKeyHint property for input elements. (@​eps1lon in #​18634)
• Warn when no value is provided to <Context.Provider>. (@​charlie1404 in #​19054)
• Warn when memo or forwardRef components return undefined. (@​bvaughn in #​19550)
• Improve the error message for invalid updates. (@​JoviDeCroock in #​18316)
• Exclude forwardRef and memo from stack frames. (@​sebmarkbage in #​18559)
• Improve the error message when switching between controlled and uncontrolled inputs. (@​vcarl in #​17070)
• Keep onTouchStart, onTouchMove, and onWheel passive. (@​gaearon in #​19654)
• Fix setState hanging in development inside a closed iframe. (@​gaearon in #​19220)
• Fix rendering bailout for lazy components with defaultProps. (@​jddxf in #​18539)
• Fix a false positive warning when dangerouslySetInnerHTML is undefined. (@​eps1lon in #​18676)
• Fix Test Utils with non-standard require implementation. (@​just-boris in #​18632)
• Fix onBeforeInput reporting an incorrect event.type. (@​eps1lon in #​19561)
• Fix event.relatedTarget reported as undefined in Firefox. (@​claytercek in #​19607)
• Fix "unspecified error" in IE11. (@​hemakshis in #​19664)
• Fix rendering into a shadow root. (@​Jack-Works in #​15894)
• Fix movementX/Y polyfill with capture events. (@​gaearon in #​19672)
• Use delegation for onSubmit and onReset events. (@​gaearon in #​19333)
• Improve memory usage. (@​trueadm in #​18970)

React DOM Server

• Make useCallback behavior consistent with useMemo for the server renderer. (@​alexmckenley in #​18783)
• Fix state leaking when a function component throws. (@​pmaccart in #​19212)

React Test Renderer

• Improve findByType error message. (@​henryqdineen in #​17439)

Concurrent Mode (Experimental)

• Revamp the priority batching heuristics. (@​acdlite in #​18796)
• Add the unstable_ prefix before the experimental APIs. (@​acdlite in #​18825)
• Remove unstable_discreteUpdates and unstable_flushDiscreteUpdates. (@​trueadm in #​18825)
• Remove the timeoutMs argument. (@​acdlite in #​19703)
• Disable <div hidden /> prerendering in favor of a different future API. (@​acdlite in #​18917)
• Add unstable_expectedLoadTime to Suspense for CPU-bound trees. (@​acdlite in #​19936)
• Add an experimental unstable_useOpaqueIdentifier Hook. (@​lunaruan in #​17322)
• Add an experimental unstable_startTransition API. (@​rickhanlonii in #​19696)
• Using act in the test renderer no longer flushes Suspense fallbacks. (@​acdlite in #​18596)
• Use global render timeout for CPU Suspense. (@​sebmarkbage in #​19643)
• Clear the existing root content before mounting. (@​bvaughn in #​18730)
• Fix a bug with error boundaries. (@​acdlite in #​18265)
• Fix a bug causing dropped updates in a suspended tree. (@​acdlite in #​18384 and #​18457)
• Fix a bug causing dropped render phase updates. (@​acdlite in #​18537)
• Fix a bug in SuspenseList. (@​sebmarkbage in #​18412)
• Fix a bug causing Suspense fallback to show too early. (@​acdlite in #​18411)
• Fix a bug with class components inside SuspenseList. (@​sebmarkbage in #​18448)
• Fix a bug with inputs that may cause updates to be dropped. (@​jddxf in #​18515 and @​acdlite in #​18535)
• Fix a bug causing Suspense fallback to get stuck. (@​acdlite in #​18663)
• Don't cut off the tail of a SuspenseList if hydrating. (@​sebmarkbage in #​18854)
• Fix a bug in useMutableSource that may happen when getSnapshot changes. (@​bvaughn in #​18297)
• Fix a tearing bug in useMutableSource. (@​bvaughn in #​18912)
• Warn if calling setState outside of render but before commit. (@​sebmarkbage in #​18838)

v18.3.1

Compare Source

v18.3.0

Compare Source

v18.2.0

Compare Source

React DOM

• Provide a component stack as a second argument to onRecoverableError. (@​gnoff in #​24591)
• Fix hydrating into document causing a blank page on mismatch. (@​gnoff in #​24523)
• Fix false positive hydration errors with Suspense. (@​gnoff in #​24480 and @​acdlite in #​24532)
• Fix ignored setState in Safari when adding an iframe. (@​gaearon in #​24459)

React DOM Server

• Pass information about server errors to the client. (@​salazarm and @​gnoff in #​24551 and #​24591)
• Allow to provide a reason when aborting the HTML stream. (@​gnoff in #​24680)
• Eliminate extraneous text separators in the HTML where possible. (@​gnoff in #​24630)
• Disallow complex children inside <title> elements to match the browser constraints. (@​gnoff in #​24679)
• Fix buffering in some worker environments by explicitly setting highWaterMark to 0. (@​jplhomer in #​24641)

Server Components (Experimental)

• Add support for useId() inside Server Components. (@​gnoff in #​24172)

v18.1.0

Compare Source

React DOM

• Fix the false positive warning about react-dom/client when using UMD bundle. (@​alireza-molaee in #​24274)
• Fix suppressHydrationWarning to work in production too. (@​gaearon in #​24271)
• Fix componentWillUnmount firing twice inside of Suspense. (@​acdlite in #​24308)
• Fix some transition updates being ignored. (@​acdlite in #​24353)
• Fix useDeferredValue causing an infinite loop when passed an unmemoized value. (@​acdlite in #​24247)
• Fix throttling of revealing Suspense fallbacks. (@​sunderls in [#​24253](https://redirect.github.com/facebook/react/pul